<html>

<head>
{head}
</head>

<body>
<p align="right"><br></p>
<h1 align="center">How to use</h1>
<p align="right">{date}</p>
<br>

<h3>Supported sites</h3>
<ul>
<li><a href="https://github.com/KurtBestor/Hitomi-Downloader#supported-sites">https://github.com/KurtBestor/Hitomi-Downloader#supported-sites</a></li>
</ul>

<h3>Address bar</h3>
<ul>
<li>Type some URLs into the address bar and click the Download button to download</li>
<li>Examples:<br>
https://hitomi.la/galleries/123.html<br>
https://hitomi.la/reader/123.html<br>
https://e-hentai.org/g/123/356dfa74ce/<br>
https://e-hentai.org/s/600e752112/123-4<br>
https://hiyobi.me/reader/123<br>
123<br>
<br>
https://www.pixiv.net/users/11<br>
https://www.pixiv.net/member_illust.php?id=11<br>
https://pixiv.me/pixiv<br>
pixiv_11<br>
<br>
https://twitter.com/TensorFlow<br>
@TensorFlow<br>
<br>
https://www.instagram.com/user_name<br>
insta_user_name<br>
<br>
https://username.deviantart.com<br>
deviant_username
</li>
<li>Examples for multiple URLs:<br>
123, 125, 126<br>
123 125 126
</li>
<li>Numbers not in Hitomi.la are automatically converted to E(x)Hentai URL.</li>
</ul>

<h3>Save</h3>
<ul>
<li>Save the preferences and tasks currently added.</li>
<li>File - Save</li>
<li>[Ctrl + S] key</li>
</ul>

<h3>Searcher</h3>
<ul>
<li>Search galleries</li>
<li>Menu - Searcher...</li>
<li>[Ctrl + F] key</li>
</ul>

<h3>Downloader tasks</h3>
<ul>
<li>Open the first file:<br>
Mouse right-click → [Open the first file]<br>
Click thumbnail<br>
Double-click<br>
[Enter] key
</li>
<li>Remove multiple tasks:<br>
Select multiple tasks → [Del] key
</li>
<li>Delete multiple files:<br>
Select multiple tasks → Mouse right-click → [Delete files]<br>
Select multiple tasks → [Shift] + [Del] key
</li>
<li>Remove all complete tasks:<br>
Mouse right-click → [Remove all complete tasks]<br>
Remove all complete tasks which are not locked.
</li>
</ul>

<h3>Task colors</h3>
<ul>
<li>Light gray: Wating or Reading</li>
<li>Dark gray: Downloading</li>
<li>Green: Downloaded completely</li>
<li>Orange: Downloaded incompletely</li>
<li> &nbsp; &nbsp;Red: Fail or Invalid</li>
</ul>

<h3>Change the order of tasks</h3>
<ul>
<li>Drag and drop with the mouse wheel button to change the order.</li>
<li>Following commands are also working: [Ctrl + ↑], [Ctrl + ↓], [Ctrl + Home], [Ctrl + End].</li>
</ul>

<h3>Filtering the List of tasks</h3>
<ul>
<li>Click the filter icon at the bottom left of the downloader window and type.</li>
<li>Only tasks with a title that contains that word are visible.</li>
<li>You can also filter by type, such as "type:youtube".</li>
<li>If you type "dup:", you will see only duplicate tasks.</li>
<li>Type "rem:" to see only the tasks that have been deleted from the physical storage.</li>
<li>You can filter by tags such as "tag:glasses".</li>
<li>You can filter by comments, such as "comment:xxxx".</li>
<li>Type "bad:" to show only incomplete tasks.</li>
</ul>

<h3>Filtering the Searcher search list</h3>
<ul>
<li>Click the filter-shaped icon in the bottom left corner of Searcher and enter something</li>
<li>You'll only see galleries with titles, authors, groups, tags, and languages that contain those characters.</li>
<li>If you enter &quot;title:A&quot;, you will only see galleries with titles that contain the letter A.</li>
<li>You can also filter by &quot;artist:A&quot;, &quot;group:A&quot;, &quot;tag:A&quot;, &quot;lang:A&quot;, etc.</li>
<li>Enter &quot;p&lt;100&quot; to see only galleries with less than 100 pages.</li>
<li>Enter &quot;p&gt;100&quot; to see only galleries with more than 100 pages.</li>
<li>Enter &quot;done:o&quot; to see only galleries that have already been downloaded.</li>
<li>Enter &quot;done:x&quot; to see only galleries that you have not yet downloaded.</li>
</ul>

<h3>Select pages &amp; Download</h3>
<ul>
<p><img src="imgs/down_menu_en.png" /></p>
<li>Downloads only the pages you specify.</li>
<li>Examples:<br>
~ 100 &nbsp; &nbsp;→ &nbsp;First 100 pages<br>
-100 ~ &nbsp; &nbsp;→ &nbsp;Last 100 pages<br>
1, 10 ~ 20, -1 &nbsp; &nbsp;→ &nbsp;First page, 10 ~ 20 pages, Last page</li>
</ul>

<h3>Select chapters &amp; Download</h3>
<ul>
<p><img src="imgs/down_menu_chapter_en.png" /></p>
<li>Download only selected episodes.</li>
</ul>

<h3>Preferences</h3>
<ul>
<li>Options → Preferences</li>
</ul>

<h3>Simple search - Search keywords</h3>
<ul>
<li>Search like Google.</li>
<li>Examples :<br>
maid<br>
maid glasses korean<br>
maid -schoolgirl<br>
maid n/a<br>
maid (korean + n/a)</li>
</ul>

<h3>Advanced Search - Title</h3>
<ul>
<li>Examples :<br>
maid<br>
maid -schoolgirl<br>
maid glasses</li>
</ul>

<h3>Advanced Search - Artists</h3>
<ul>
<li>Examples :<br>
sekiya asami<br>
sekiya asami + amezawa koma</li>
</ul>

<h3>Advanced Search - Characters</h3>
<ul>
<li>Examples :<br>
chino kafuu<br>
chino kafuu + kokoa hoto<br>
hino kafuu, kokoa hoto</li>
</ul>

<h3>Advanced Search - Tags</h3>
<ul>
<li>Examples :<br>
female:maid<br>
female:maid, -female:schoolgirl uniform</li>
</ul>

<h3>Searcher List</h3>
<ul>
<li>Download multiple galleries :<br>
Select multiple → Right click → [Download]<br>
Select multiple → [Enter] key</li>

<li>View gallery information :<br>
Right click → Gallery Info...<br>
Click thumbnail</li>
</ul>


<h3>To stop searching</h3>
<ul>
<li>Click the search button one more time</li>
</ul>

<h3>Update Searcher search data</h3>
<ul>
<li>Searcher - Menu - Download data...</li>
<li>Each time you re-download the data, it will fetch the latest data from the server.</li>
</ul>

<h3>Scripts</h3>
<ul>
<li>Tools - Import script...</li>
<li>Execute python script.</li>
<li>You can create your own download scripts, add them, and more.</li>
<li>Script files (*.hds) can be modified with a text editor (such as Notepad).</li>
<li>You can also drag &amp; drop script files into the program to run them.</li>
<li>Create a scripts folder in your executable path and put your script files (*.hds) in it to run them automatically at startup.</li>
<li>Download scripts :<br>
<a href="https://github.com/KurtBestor/Hitomi-Downloader/wiki/Scripts">https://github.com/KurtBestor/Hitomi-Downloader/wiki/Scripts</a></li>
<li>How to write a script :<br>
<a href="https://github.com/KurtBestor/Hitomi-Downloader/wiki/How-to-write-a-script">https://github.com/KurtBestor/Hitomi-Downloader/wiki/How-to-write-a-script</a></li>
</ul>

<h3>Bypass DPI</h3>
<ul>
<li>Options - Preferences - Network Settings - Bypass DPI</li>
<li>Use <a href="https://github.com/ValdikSS/GoodbyeDPI">GoodbyeDPI</a> to block / bypass DPI (Deep Packet Inspection).</li>
</ul>

<h3>Load cookies</h3>
<ul>
<li>Options - Preferences - Network Setting - Cookies - Load...</li>
<li>Cookies exported from browser extensions can be loaded. (Netscape HTTP Cookie File)</li>
<li>Using these cookies, Hitomi Downloader can access login-required pages.</li>
<li>Chrome extension: <a href="https://chrome.google.com/webstore/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc">Get cookies.txt LOCALLY</a></li>
<li>Firefox extension: <a href="https://addons.mozilla.org/en-US/firefox/addon/cookies-txt/">cookies.txt</a></li>
<li>Edge extension: <a href="https://microsoftedge.microsoft.com/addons/detail/get-cookiestxt/helleheikohejgehaknifdkcfcmceeip">Get cookies.txt</a></li>
<li>Expired cookies are shown in gray.</li>
</ul>

<h3>Built-in Web browser</h3>
<ul>
<li>Options - Preferences - Network Setting - Built-in Web browser - View</li>
<li>Used to read pages that require JS rendering.</li>
<li>You can use this to update cookies.</li>
</ul>

<h3>Chrome Extension</h3>
<ul>
<li><a href="https://github.com/KurtBestor/Hitomi-Downloader/wiki/Chrome-Extension">Hitomi Downloader</a></li>
<li>Functions:<br>
Download sites that require the extension<br>
Update cookies
</ul>

<h3>Save</h3>
<ul>
<li>Save &amp; Quit :<br>
Quit with saving settings and currently added lists</li>
<li>Quit :<br>
Quit without saving</li>
<li>When launching the app, it starts with the most recent saved state.</li>
</ul>

<h3>Shortcuts</h3>
<ul>
<li>Alt + D : Address bar ↔ toggle task list</li>
<li>Ctrl + 1 ~ 7 : Set tags in tasks</li>
<li>Ctrl + Tab : Show/Hide Toolbar</li>
<li>Ctrl + - / + : Thumbnail size adjustment</li>
<li>Ctrl + Scroll : Thumbnail size adjustment</li>
<li>Space : Expand/Collapse Group(s)</li>
</ul>

<h3>Feedback</h3>
<ul>
<li><a href="https://github.com/KurtBestor/Hitomi-Downloader/issues">https://github.com/KurtBestor/Hitomi-Downloader/issues</a></li>
</ul>

<h3>Etc.</h3>
<ul>
<li>Please use the downloaded files for personal use only.</li>
<li>Please look for further updates at Help - About - Bottom button.</li>
</ul>

</body>

</html>
